Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Setting Source Characteristics

VDSetDigitizerRect

The VDSetDigitizerRect function allows applications to set the current digitizer rectangle.

pascal VideoDigitizerError VDSetDigitizerRect
                                  (VideoDigitizerComponent ci,
                                     Rect *digitizerRect);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

digitizerRect

Contains a pointer to a rectangle that contains the size and location information for the digitizer rectangle. The coordinates of this rectangle must be relative to the maximum source rectangle. In addition, the digitizer rectangle must be within the maximum source rectangle.

DESCRIPTION

The current digitizer rectangle defines the area that the digitizer component reads from the input video signal. Applications can crop the input video signal by manipulating this rectangle. The digitizer rectangle coordinates must be specified relative to the maximum source rectangle. Furthermore, the digitizer rectangle must be completely within the maximum source rectangle. For a complete discussion of the relationship between these rectangles, see "About Video Digitizer Components," which begins on page 8-3.

All video digitizer components must support this function.

RESULT CODES

noErr	0	No error
qtParamErr	-2202	Invalid parameter value

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help